Alessandro Levi Montalcini C.so Re Umberto 10 10121 Torino Italy e-mail: alm@torino.alpcom.it ftp://ftp.alpcom.it/software/mac/LMontalcini ftp://ftp.alpcom.it/software/mac/LMontalcini/alm.html   DBugR 1.2.2 documentation - May 1996 • Introduction ◊ DBugR is a cool Control Panel for programmers and hackers who often have to break into MacsBug (or any other debugger supporting the _DebugStr trap). It puts a floating "small bomb" icon on your desktop which acts like a button. If the mouse button is pressed and released inside the icon, a user interrupt is invoked and MacsBug pops out. DBugR can show some basic info about the current application (name, free memory, max free block) and/or send one of two user-configurable MacsBug commands to be executed immediately upon breaks (hold down the Option key when clicking to send the alternate command). The icon may be moved anywhere on any monitor by holding down the Shift key and dragging it around. ◊ DBugR only takes about 6K of system memory and 35K of disk space. • Special keys ◊ You may hold down the following keys when clicking in the DBugR icon: - [SHIFT] lets you drag the DBugR icon somewhere else; - [COMMAND] forces DBugR to send a MacsBug command even if the "Always send" option is not checked (if the option is checked, the Command key has no effect); - [OPTION] makes DBugR send the alternate command string (this key may be combined with the Command key). • The control panel ◊ This is what you'll see in the Control Panel: - [On/Off] Activate/deactivate in case you don't have a startup/extensions manager; - [Info] Brings up a brief shareware notice; - [Corner] Sets the default corner for the DBugR icon, which can later be moved by holding down the Shift key; - [Set Cmd] Change the command strings that can be sent to MacsBug at breaks; - [Always send command] …or do it only when the Command key is down; - [Show application info] Show current application's name and free memory or don't; - [Show icon at startup] Display DBugR's icon at startup time or don't. • Version history ◊ 1.2.2 - Now freeware, updated documentation. ◊ 1.2.1 - Added pictures and a contents menu to the online documentation. ◊ 1.2 - Fixed some bugs in the control panel and added online documentation. ◊ 1.1 - Now checks for a low-level debugger before calling it. ◊ 1.05 - Minor fixes. ◊ 1.04 - Now works under System 6 (checks the BitMapToRgn trap before calling it). ◊ 1.03 - Changed key combinations: Shift moves the icon, Command sends a command, Option activates the alternate command string. ◊ 1.02 - Added a second command string that replaces the first when the Command (now Option in 1.03) key is held down; also, holding down the Shift (now Command in 1.03) key will force DBugR to send a command string even if the "Always send command" option is not checked. ◊ 1.01 - Added control panel interface and user-configurable MacsBug command. Most changes to the control panel settings take effect immediately. ◊ 1.0 - First cut, the DBugR icon floats and calls MacsBug without any trouble. • Thanks to… ◊ Fabrizio Oddone, who came out with the original idea, suggested the alternate command string and also did the beta-testing; ◊ Alberto Ricci, who didn't do anything except being a good friend as always; ◊ Richard E. Brown and Paul L. Merchant Jr. for their hint on debugger checking. • Distribution ◊ This software is ©1994-96 Alessandro Levi Montalcini. It can be freely distributed as long as it is not modified and there’s no charge for it, but it may not be included in any commercial package without my consent. ◊ All online services and bulletin boards may make it available to their users at no charge other than the normal connection fees. ◊ All non-profit user groups may distribute it at no charge. ◊ All magazines may publish it on floppy disk or CD-ROM without asking me first, as long as I get a copy of the issue containing my software. ◊ All CD-ROM shareware collections and CD-ROM magazines may include it without my prior consent, as long as I get either a copy of the CD-ROM or an offer to buy the CD-ROM at a discounted price. ◊ All redistribution companies such as Pacific HiTech, AMUG, Celestin or Educorp may distribute it, as long as I get a copy of each media containing my software and a catalog of the company’s offerings (where applicable). ◊ You may find the latest version of all my shareware and freeware programs by anonymous ftp to ftp.alpcom.it, inside the /software/mac/LMontalcini directory. The ALM Share and ALM Free packages, which contain most of my stuff and can be registered at a very low price, are also available there. • Disclaimer ◊ This software should never cause any damage, but you’re using it at your own risk. As an independent software developer, I can make no warranties whatsoever on it. • Have fun! ◊ And don’t forget to register your shareware, so that more cool inexpensive utilities can see the light in the future.